Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Working With Sound Channels

SGSetSoundInputDriver

Some sound channel components may use sound input devices to obtain their source data. The SGSetSoundInputDriver function allows you to assign a sound input device to a sound channel.

pascal ComponentResult SGSetSoundInputDriver (SGChannel c, 
                                       const Str255 driverName);

c

Specifies the reference that identifies the channel for this operation. You obtain this reference from the SGNewChannel function, described on page 5-29.

driverName

Specifies the name of the sound input device. This is a Pascal string, and it must correspond to a valid sound input device.

DESCRIPTION

If the sound channel component does not use sound input devices, it returns a nonzero result code. For more information about sound input devices, see Inside Macintosh: More Macintosh Toolbox--in particular, refer to the discussion of the Sound Manager's SPBGetIndexedDevice routine.

SPECIAL CONSIDERATIONS

You cannot call the SGSetSoundInputDriver function during a record operation.

RESULT CODES

noDeviceForChannel	-9400	Channel component cannot find its device
cantDoThatInCurrentMode	-9402	Request invalid in current mode
deviceCantMeetRequest	-9408	Device cannot support grabber

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help